home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / progs / utility / opaquemove / docs-txt / english / opaque-ui.txt < prev    next >
Text File  |  1996-10-21  |  9KB  |  257 lines
  1.  
  2.  
  3. Title: OpaqueMove User Interface
  4.  
  5.  
  6. User Interface
  7.  
  8. MUI
  9.  
  10. The OpaqueMove user interface is written using the MUI object library. For
  11. information on using MUI programs, see the MUI documentation.
  12.  
  13. MUI is a much more powerful UI system than Gadtools, and as you can see if
  14. you are viewing this page on a screen with at least 32 free colormap entries,
  15. it also looks a lot nicer. It is almost endlessly customizable.
  16.  
  17. It is recommended that you register MUI. It is not expensive, and well worth
  18. the small cost.
  19.  
  20. Back to Top
  21.  
  22. Save/Use/Cancel
  23.  
  24. [Save/Use/Cancel Image]
  25.  
  26. The Save button will close the UI window and save the current preferences
  27. settings to ENVARC:OpaqueMove/Opaque.Prefs and ENV:OpaqueMove/Opaque.Prefs.
  28.  
  29. The Use button will close the UI window and save the current preferences
  30. settings only to ENV:OpaqueMove/Opaque.Prefs.
  31.  
  32. The Cancel button will close the UI window and re-load the last set of
  33. preferences saved to ENV:OpaqueMove/Opaque.Prefs, which will cancel any
  34. changes since the last Save or Use.
  35.  
  36. Back to Top
  37.  
  38. Move/Size Preferences
  39.  
  40. [Move/Size Window Image]
  41.  
  42. This is the movement preferences window; the size preferences window looks
  43. similar. This window allows you to set various preferences related to which
  44. windows are or are not moved opaquely.
  45.  
  46. Allow Screen
  47.      An AmigaOS wildcard pattern. The screen title of the current screen must
  48.      match this pattern before any windows on the screen may be moved
  49.      opaquely.
  50.  
  51. Allow Window
  52.      Similar to Allow Screen but a matter which window titles must match
  53.      before the window may be moved opaquely.
  54.  
  55. Deny Screen
  56.      Similar to Allow Screen, but any windows on a screen matching this
  57.      pattern will not be moved opaquely.
  58.  
  59. Deny Window
  60.      Counterpart to Allow Window.
  61.  
  62. Screen Depths
  63.      A window's containing screen depth must be checked in this list before
  64.      the window may be moved opaquely. This is useful for non-graphics card
  65.      screens where some bit depths may be very slow to render graphics. On
  66.      modern graphics cards under the CyberGfx system, this makes little
  67.      difference.
  68.  
  69. Max Windows
  70.      Since screens with many windows may be slow, this is a limit for how
  71.      many windows the screen may contain before opaque movement is turned
  72.      off.
  73.  
  74. Max WinX
  75.      Since large windows may be slow to move on some graphics devices,
  76.      windows larger than this width will by moved by outline.
  77.  
  78. Max WinY
  79.      Similar to Max WinX but for height instead of width.
  80.  
  81. Refresh Simple
  82.      On most graphics devices, simple refresh windows are faster to move than
  83.      smart refresh. If this button is checked, simple refresh windows may be
  84.      moved opaquely.
  85.  
  86. Refresh Smart
  87.      Under standard Intuition, smart refresh windows can be very slow to
  88.      move. This gadget may be toggled off to stop smart refresh windows from
  89.      being moved opaquely. Note that the qlayers patch may be installed to
  90.      speed up movement of smart refresh windows, in which case it might be
  91.      practical to check this option.
  92.  
  93. Qualifier
  94.      The qualifier that must be pressed before opaque movement is performed.
  95.      This can be "None" (mostly useful in combination with the Drag Bar
  96.      control option), or you can select from various qualifier keys such as
  97.      shift, control, and so on. There are two sets of Qualifier/Control
  98.      combinations, so you can specify conditions such as "No
  99.      Qualifier/Dragbar, or Control Key/Center.
  100.  
  101. Control
  102.      Specifies the location in which a window must be grabbed before it can
  103.      be moved opaquely. This can be Anywhere (useful with qualifier keys),
  104.      Drag Bar (useful either with or without qualifier keys), Center (useful
  105.      with external size commodities), or Off.
  106.  
  107. The Size preferences window is almost identical to the movement preferences
  108. window, except that the possible control locations are different:
  109.  
  110. Control
  111.      Specifies the location in which a window must be grabbed before it can
  112.      be sized opaquely. This can be Gadget (useful with or without
  113.      qualifiers), Edge/Corner (the window may be grabbed near any edge or
  114.      corner, useful with qualifier keys), Edge (only window edges but not
  115.      corners count), corner (only window corners but not edges count),
  116.      Edge/Corner/Gadget, or Off.
  117.  
  118. Back to Top
  119.  
  120. General Preferences
  121.  
  122. [General Prefs Window Image]
  123.  
  124. This is the general preferences window. It controls various preferences:
  125.  
  126. Global Deny Screen
  127.      Some programs, such as Final Writer, appear not to work correctly with
  128.      OpaqueMove. Any screen or window matching this pattern will not be moved
  129.      either by outline or opaquely by OpaqueMove.
  130.  
  131. Global Deny Window
  132.      Similar to Global Deny Screen but for windows.
  133.  
  134. Border Width
  135.      This controls the border width for the "Center" drag location, and the
  136.      edge & corner widths for the associated size locations. For example, if
  137.      you are using Edge/Corner sizing, then you must grab the window closer
  138.      than this many pixels to an edge or corner.
  139.  
  140. Key File
  141.      This is the location of your OpaqueMove key file. Without a registered
  142.      key file, the program is fully functional, but there is a shareware
  143.      requester presented at start time, and the "About" menu will list the
  144.      program as unregistered.
  145.  
  146. Brush Dir
  147.      This is the directory that contains the custom IFF brushes that will be
  148.      used if the Custom Cursors option is checked. The brush names under this
  149.      directory are always fixed:
  150.  
  151.      Brush.Move
  152.      Brush.Size_LF
  153.      Brush.Size_RT
  154.      Brush.Size_UP
  155.      Brush.Size_DN
  156.      Brush.Size_UPLF
  157.      Brush.Size_UPRT
  158.      Brush.Size_DNLF
  159.      Brush.Size_DNRT
  160.  
  161.      There is one cursor for window movement, and 8 for sizing (one for each
  162.      corner, and one for each edge). Brushes must be 2 plane IFF files, with
  163.      a GRAB chunk to indicate the cursor hotspot. Transparent colors and so
  164.      on depend on your specific graphics device.
  165.  
  166.      OpaqueMove includes two sets of cursors. The Shadowed set assumes that
  167.      Color 0 is transparent, color 1 is the primary cursor color, color 2 is
  168.      also transparent, and color 3 is a dark shadow color (usually black).
  169.      This is an appropriate scheme for most Amiga graphics card, and the
  170.      colors may be set in the Sys:Prefs/Pointer program. They will not be
  171.      changed by OpaqueMove. The Flat set uses only color 1.
  172.  
  173. Custom Cursors
  174.      If this is checked, OpaqueMove will use the custom cursors from BrushDir
  175.      will be used for movement or sizing. All of the supplied cursors have
  176.      been designed to look good in high res mode on graphics cards (set with
  177.      the sys:Prefs/Pointer program), when pointer color 1 is bright, and
  178.      color 3 is black.
  179.  
  180. Show Size/Pos Win
  181.      If this is checked, a small window showing the current size and location
  182.      of the window being moved or sized is shown, like this:
  183.  
  184.      [Size/Pos Window Img]
  185. Friendly Layers Lock
  186.      Not yet functional.
  187.  
  188. Hide Win on Start
  189.      If this is checked, then OpaqueMove will start iconified. Note that an
  190.      unregistered OpaqueMove will not do this, since it always displays the
  191.      registration requestor at startup. But this will work for registered
  192.      versions. Whether an actual icon is generated depends on the MUI
  193.      configuration set up in MUI preferences (MUI:MUI).
  194.  
  195. Back to Top
  196.  
  197. Menus
  198.  
  199. Project
  200.  
  201. Open...
  202.      This will present a requester from which a previously saved preferences
  203.      file may be loaded.
  204.  
  205. Save
  206.      Identical to the Save button, this will save the current preferences
  207.      settings to ENVARC: and ENV:, but will not close the window.
  208.  
  209. Save As...
  210.      This will present a requestor for saving preferences settings in an
  211.      arbitrary location.
  212.  
  213. About...
  214.      This will display a small window showing the program version,
  215.      registration information, and a few other items.
  216.  
  217. Register...
  218.      This will display the registration window which may be used to generate
  219.      a file to be used for email or postal mail registration. See also
  220.      Registration.
  221.  
  222. Hide
  223.      This will iconify the window. Whether an actual icon is displayed is
  224.      controlled by the MUI preferences.
  225.  
  226. Quit
  227.      This will exit the program.
  228.  
  229. Edit
  230.  
  231. Restore
  232.      This will load the last set of settings from ENV: without closing the
  233.      window.
  234.  
  235. Last Saved
  236.      This will load the last set of settings saved to ENVARC without closing
  237.      the window
  238.  
  239. Settings
  240.  
  241. MUI...
  242.      This will show the MUI preferences window for OpaqueMove.
  243.  
  244. Back to Top
  245.  
  246. Quitting
  247.  
  248. OpaqueMove can be shut down by any of the following methods:
  249.  
  250.    o Sending a control-C signal to the process.
  251.    o Using the Commodities Exchange window to remove the commodity.
  252.    o Selecting Project/Quit from the OpaqueMove menus.
  253.  
  254. Back to Contents
  255. -----------------------------------------------------------------------------
  256.  
  257.